home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / pcmous13.zip / PCMOUSE.DOC < prev    next >
Text File  |  1994-03-14  |  8KB  |  212 lines
  1.  
  2. PCMOUSE.DOC - documentation of PCMOUSE 1.3
  3.  
  4. 31-Jan-94
  5.  
  6.  
  7. PC-MOUSE: Paste what you have Cut with your MOUSE 
  8.           in the text-modes of DOS or OS/2 2.x VDM.
  9.           PCMOUSE is a shareware program but free 
  10.           for personal use.
  11.  
  12.  
  13.         The author does not warrant the correctness of the documentation
  14. or the function of the program and does not warrant uninterrupted or
  15. error free operation of the Program.
  16.         The user is advised to test the program fully. The risk of using
  17. this software is exclusively at the user. The author assumes no liability
  18. whatever for damages of any kind that might result from using the program.
  19.  
  20. Cited product names are trade names.
  21.  
  22.  
  23.  
  24. PCMOUSE copyright (c) 1992,1994 by Jürgen Weber
  25.                               
  26.  
  27. Jürgen Weber
  28. Wiesentalstraße 1
  29. D-74523 Schwäbisch Hall
  30. Germany - European Union
  31.  
  32. email: weberj@dialog.informatik.uni-stuttgart.de
  33.  
  34. Please send comments or reports of reproduceable bugs to the email
  35. address.
  36.  
  37. INTRODUCTION:
  38.  
  39. Do you prefer the well readable text mode of your video card to the
  40. flicker of graphical user interfaces but would like to simply copy
  41. text by selecting and inserting it with your mouse (cut and paste)?
  42. Then you should use PCMOUSE. After going resident PCMOUSE enables Cut
  43. and Paste in the text modes of PC video cards. Programs that use the
  44. mouse themselves work as usual and ignore the presence of PCMOUSE.
  45.  
  46. VERSIONS: 1.0     First public release
  47.           1.1     if you specify option /T PCMOUSE's buffer is stuffed
  48.                   into the keyboard buffer at every timer tick, too.
  49.           1.2     Un-install Option /U
  50.                   8088 Version
  51.           1.3     Support of extended text modes
  52.                   Option /Mnnn to use (decimally given marker byte nnn)
  53.  
  54. HARDWARE/SOFTWARE NEEDED:
  55.  
  56. 80286 or better (not necessary for 8088 version)
  57. Bios with extended keyboard support (not necessary for 8088 version)
  58. Microsoft compatible mouse
  59.  
  60. New mouse driver (with functions 14h,21h)
  61.  
  62. MS-DOS compatible operating system (OS/2 2.x Dos Emulation is o.k.)
  63.  
  64. (PCMOUSE complains if you lack anything.)
  65.  
  66. SHAREWARE: 
  67.  
  68. PCMOUSE may be freely copied provided that you copy the complete
  69. package.
  70.  
  71. The package consists of:
  72.  
  73. PCMOUSE  EXE      3133  14.03.94 20.21  : PC-Mouse executable
  74. PCMOUSE  ASM     30607  14.03.94 20.21  : Source Code
  75. PCMOUSE  DOC                            : the file you are reading
  76.  
  77.  
  78. PCMOUSE is free for personal use.
  79.  
  80. If you like PCMOUSE please send me a postcard that shows your part of 
  81. the world. Then I can show my friends where my programs are used.
  82.  
  83.  
  84. Business users may try the program for a period of thirty days. After
  85. that time they must discontinue using PCMOUSE or pay the registration
  86. fee (40 US Dollars or 50 German Marks). Please send bills or a check
  87. to the above address.
  88.  
  89.  
  90. HOW TO USE:
  91.  
  92. If you start PCMOUSE.EXE it displays an identification message and
  93. goes resident. If PCMOUSE is already installed or if it hasn't found
  94. the right processor, bios or mouse driver, it aborts with an error
  95. message.
  96. If you do not use the mouse you will see no sign of PCMOUSE being
  97. present. Only when you move the mouse, the mouse cursor gets visible.
  98. It gets hidden again as soon as the next character is displayed on
  99. screen. To select a text area move the mouse cursor to the beginning of
  100. the area. Keep the left button pressed and move over the area you want
  101. to select. When you release the left button the selected text is
  102. copied to PCMOUSE's internal buffer.
  103. If the mouse cursor is on a word you can select it by double clicking
  104. the left button. A word is a sequence of letters, digits, the
  105. underline character and European special letters (IBM ascii values 80h
  106. to 0a5h, 0e0h to 0ebh).
  107. If you select a new screen area the internal buffer is overwritten. If
  108. you press and release the left button without selecting an area the
  109. internal buffer is cleared.
  110. Press the right mouse button to simulate the content of the buffer being
  111. typed in with the keyboard. If you keep the CONTROL key pressed
  112. while pressing the right button, an additional pressing of ENTER is
  113. simulated.
  114. PCMOUSE's internal buffer has space for 1024 characters. If you
  115. selected a text that is too large to fit into the buffer the last part
  116. is discarded. But the buffer gets rarely full as blanks are
  117. compressed. Also blanks at the end of a line are discarded. After the
  118. last non-blank of a line PCMOUSE inserts a CR char to simulate
  119. pressing ENTER. Control characters with ascii values below 32 are not
  120. stored in the buffer and discarded.
  121. The selected area is de-selected as soon as you press the left key
  122. again or if anything is displayed on the screen. This is done because
  123. the programs you run don't know anything about the selection. The
  124. de-selecting is done to prevent chaos on the screen. There can be
  125. problems if programs write directly to the screen memory which PCMOUSE
  126. can't intercept. But this occurs rarely and causes only optical harm.
  127. Programs run as usual. If a program offers mouse support itself the
  128. mouse functions of PCMOUSE lay dormant until the program ends.
  129.  
  130. MONOCHROME CARDS:
  131.  
  132. On monochrome systems (Hercules compatible cards) you could try
  133. option /M119 to get a well visibly selection on screen.
  134.  
  135.  
  136. TECHNICAL NOTES:
  137.  
  138. PCMOUSE hooks interrupts 10h, 16h and 21h. Int 10h is hooked to
  139. de-select a selected screen region every time a program calls int 10h.
  140. Int 16h is hooked to read from PC-Mouse's buffer. It also gets a new
  141. function 80h that PCMOUSE uses to see if it is already installed.
  142.  
  143. With int 21h the exec function is patched. Before each program start
  144. via exec the previously installed mouse handler is saved on the stack
  145. and the mouse routine of PCMOUSE is activated. After the exec
  146. function the previous mouse routine is restored. So PCMOUSE works at
  147. the normal dos prompt and also with dos shells started within user
  148. programs. The saving of the mouse handler on the stack is necessary
  149. because programs can call each other recursively.
  150.  
  151. But this means PCMOUSE takes some system stack. So if your system
  152. does not work with PCMOUSE, try the following in CONFIG.SYS
  153.  
  154. STACKS=9,256
  155.  
  156.  
  157. Every time a program calls the keyboard interrupt 16h PCMOUSE fills up
  158. the keyboard buffer with characters from its internal buffer.
  159. As some programs bypass int 16h and read directly from the keyboard
  160. buffer you can specify option /T so that PCMOUSE's buffer is stuffed
  161. into the keyboard buffer at every timer tick, too.
  162. This option hooks int 1ch.
  163.  
  164. Use option /u to un-install PCMOUSE. But this is only possible,
  165. if there is no other TSR loaded after PCMOUSE that hooks the
  166. same int vectors.
  167. PCMOUSE believes an extended text mode to be active if a video
  168. mode with a higher mode number than the highest in standard
  169. vga (=13h) is active and if a text page needs between
  170. 800h and 4000h bytes.
  171. If PCMOUSE does not work with an extended text mode this is not
  172. PCMOUSE's fault but the fault of the mouse driver. Well, the only driver
  173. I found that works with my ET4000 card in all text modes is the one
  174. within OS/2 2.x dos emulation.
  175.  
  176.  
  177. PCMOUSE uses a little more than 2.5K of memory and half of that is used for its
  178. text buffer.
  179. The selecting of a screen area is indicated by XORing the attribute
  180. bytes with 50h, to de-select they are simply XORed again.
  181. To use another value use the /Mnnn option. With nnn=0 you get no visible
  182. selection.
  183.  
  184.  
  185.  
  186. return values: 0  successfully installed
  187.                1  hardware/software preconditions 
  188.                   not met 
  189.                2  already installed
  190.  
  191. PROBLEMS: 
  192.  
  193.  
  194. If you leave Borland's TD386 with PCMOUSE installed it hangs the
  195. computer. When MSDOS 5.0 came out Borland had to distribute a patch
  196. for TD386 because then the same problem occurred. So this seems to be
  197. not PCMOUSE's problem but TD386's.
  198.  
  199. Some users reported that PCMOUSE did not find their mouse driver.
  200. This happens with some old drivers. To solve this problem
  201. install a new mouse driver. A new mouse driver can be found
  202. on the Windows disks.
  203.  
  204.  
  205. THE AUTHOR:
  206.  
  207. He is now (1993) 26 years old and